Copyright 1984-1998 FileMaker, Inc. HBAM2016AUG95 Pro 3.0 GXPLATFORMRETURN FPTHA HBAM3016AUG95@ 2STR >vers JSTR# bFNET ncfrg Timeouts YO/ See also the User Manual for more details. Returns the names of all serial ports that are available on the computer. Parameters: no parameters, leave empty for future use. Result: The returned result is a list of serial ports that are available on the computer that is running FileMaker Pro. Each available port is on a different line. On a Mac a typical result will be: Printer Port Modem Port On Windows the result will be: COM1 COM2 COM3 COM4 Use this function to let the user of the database choose which port to open. Store the name of the chosen port in a global field. You can then check the next time the database is opened whether the portname is still present and ask the user if he wants to change his preference. If an error occurs an error code is returned. Returned error codes can be: $$-108 memFullErr Ran out of memory Other errors might be returned. -> See also the User Manual for more details. none, leave blankj Serialu portname | switchesj Serialu Serial-Closef Closes a serial port with the specified name . If the portname parameter is "" ALL ports are closed. Parameter: portname: the name of the port to close Result The returned result is an error code: 0 no error the port was closed $$-4210 portDoesnotExistErr port is not available on this computer $$-4211 AllPortsNullErr No serial ports are available on this computer $$-108 memFullErr Ran out of memory Other errors might be returned. Example Usage This will close the COM3 poB Set Field[ gErrorCode, External("Serial-Close" , "COM3") ] This will close all open ports: Set Field[ gErrorCode, External("Serial-Close" , "") ] portnamej Serialu Serial-Receivef Serial-Sendf Sends data to the serial port with the specified name . The port needs to be opened first (See also Serial-Open). Parameters portname: the name of the port to send data to, data: the text data that is to be sent to the serial port. Result The returned result is an error code. An error always starts with 2 dollars, followed by the error code. You should always check for errors when sending by testing if the first two characters are dollars. Returned error codes can be: 0 no error the Receives data from a serial port with the specified name . The port needs to be opened first (See Serial-Open). If no data is available an empty string is returned:"". Parameter: portname: the name of the port to receive data from Result The returned result is the data received or an error code. An error always starts with 2 dollars, followed by the error code. You should always check for errors when receiving by testing if the first two characters are dollars. Returned error codes can $$-28 notOpenErr The port is not open $$-108 memFullErr Ran out of memory $$-50 paramErr There was an error with the parameter $$-4210 portDoesnotExistErr Port with this name is not available on this computer $$-4211 allPortsNullErr No serial ports are available on this computer $$-207 notEnoughBufferSpace The input buffer is full Other errors might be returned. Example Usage Set Field[ gResult, External("Serial-Receive" , "Modem port") ] This will receive data (CCfrom the Modem port. -> See also the User Manual for more details. portnamej Serialu Serial-SetDispatchScriptf Sets the Dispatch Script to call when data is received. If you give an empty parameter "", the Dispatch Script is removed. Parameters: filename: the name of the file with the Dispatch Script, scriptkey=x : the key number in the menu of the Dispatch Script. x must be in the range from 0-9. Result The returned result is an error code. An error always starts with 2 dollars, followed by the error code. You should always check for errors. Returned error codes can be: 0 no error the Dispatc h Script was set $$-50 paramErr There was an error with the parameter Other errors might be returned. Example Usage Set Field[ gErrorCode, External("Serial-SetDispatchScript", Status(CurrentFileName) & "| scriptkey=2") ] This will set the Dispatch Script to the script with shortcut control-2 (or command-2) of the current file. -> See also the User Manual under Dispatch Scripting for more details. data was send $$-28 notOpenErr The port is not open $$-108 memFullErr Ran out of memory $$-50 paramErr There was an error with the parameter $$-4210 portDoesnotExist A port with this name is not available on this computer $$-4211 AllPortsNullErr No serial ports are available on this computer $$-207 notEnoughSpace The output buffer is full Other errors might be returned. Example Usage Set Field[ gResult, External("Serial-Send" , "Modem port| So long") ] This will CZsend the string "So long" to the Modem port. -> See also the User Manual for more details. portname | dataj Serialu filename | scriptkey=x j Serialu Serial-DataWasReceivedf Returns 1 when data was received on a serial port. Use this function to see if this is an event that needs to be handled. Parameters: no parameters leave empty for future use. Result The returned result is an boolean value. Returned is either: 0 no data received 1 data was received in the buffer When this function returns 1 you can get the data with the function Serial-Receive. Example Usage If[ External("Serial-DataWasReceived", "") ] Perform Script [Sub-scripts, Process DaBzta Received Else ... do something else Endif -> See also the User Manual under Dispatch Scripting for more details. none, leave blankj Serialu Serial-RestoreSituationf Serial-ToASCIIf Converts (one or more) numbers to their equivalent ASCII characters. Parameters: ASCIInumber one or more numbers in the range from 0-255 Result The ASCII text Example Usage Set Field [text, External("Serial-ToASCII", "65|65|80|13") ] This will result in the text "AAP" where is a Carriage Return character NOTE You can also use hexadecimal notation for the numbers. Use 0x00 to 0xFF to indicate hexadecimal notation. Example Usage Set Field [text, External("Serial-ToASCIB I", "0x31|0x32|0x33|0x0D|0x0A") ] This will result in the text "123" where is a Carriage Return character and is a Line Feed character Bring the database file that was in front, before the Dispatch Script was called, back to the front. Parameters: no parameters leave empty for future use. Result The returned result is an error code: 0 no error At the moment no other results are returned. Example Usage Set Field [gErrorCode, External("Serial-RestoreSituation", "") ] -> See also the User Manual under Dispatch Scripting for more details. none, leave blankj Serialu Open file Set all globals To Menu To Overview To ReadMe Quit button dialog ----- General ------ Check plug-in ----- Documentation etc ------ Print Function Specs Copy Parameters WWW: Goto web site: www.troi.com WWW: Order via web site Print this record BeepBeep Ci0ASCIInumber1 | ASCIInumber2 | ASCIInumber3 |....j Serialu Helvetica Geneva Arial Times New Roman Monaco Courier Times Futura Courier New Palatino To Menu Check plug-in A4Important: ALWAYS check if the plug-in is available!B)Check if this is FileMaker 4.0 or higher.CQ 1)) < 4 Canceld This file requires FileMaker 4.0 or higherE*Check if the Troi FM Plug-in is available.Fz |("Troi-Version" "") 15 ) <> "Troi FM Plug-in" Troi-Version Troi FM Plug-in Set all globals ) = 1 A Open file ) = 1 Canceld Troi FM Plug-in not found. Please put the Troi FM Plug-in into the Extensions folder inside the FileMaker folder. Also enable all the plug-ins under the application preferences. Canceld Troi FM Plug-in not found. Please put the Troi FM Plug-in into the SYSTEM directory inside the FileMaker directory. Also enable all the plug-ins under the application preferences. ,A WWW: Goto web site: www.troi.com Cancel Do you want to connect to Troi's web site?B+ ) = 1 http://www.troi.com/ Button 2 Quit button dialog |("Troi-Version" "") 15 ) = "Troi FM Plug-in" Troi-Version Troi FM Plug-in ) = 2 Print Function Specs ) < 601 Copy Parameters Cancel Do you want to copy the parameters?B+ ) = 1 ----- General ------ ----- Documentation etc ------ WWW: Order via web site |("Troi-DoDialog" "Do you want to quit the FileMaker application as well?|OK|No||Cancel") Troi-DoDialog DDo you want to quit the FileMaker application as well?|OK|No||Cancel|C' Print this record BeepBeep To Overview ) = 2 hA To ReadMe ) = 2 .http://order.kagi.com/cgi-bin/register1.cgi?5iP Button 2 GRPTH FPTHAGWORF:Projecten:Troi FM Plug-In:Troi-Text-Plug-in1.0b1:Text Examples.fp3 Text Examples.fp3 FMP3FMP3 Troi-Text-Plug-in1.0b1 GWORF:Projecten:Troi FM Plug-In:Troi-Text-Plug-in1.0b1:Text Examples.fp3 MSPCA NAMEA Text Examples.fp3 RPTHA Text Examples.fp3 ZONEA 192.1.1.2 Text Examples.fp3 FMP3FMP3 Troi-Text-Plug-in1.0b1 GWORF:Projecten:Troi FM Plug-In:Troi-Text-Plug-in1.0b1:Text Examples.fp3 \RPTH ONML"" ONML"" ONML"" (LIST LISTA Full Path VDEFA( (LIST LISTA VDEFA( (LIST VDEFA( (LIST VDEFA( (LIST VDEFA( A Full PathB BooleanC TEST Cond value (does not work)D CategoriesE TEST Cond value2 (does not work) FMRLA FMRLA SameCategoryB SelectedCategory FPTHA\KES:Projecten:Troi Plug-In 981215:Troi Plug-ins:SERIAL:Troi-Serial-Plug-in1.0b1:SeriExpl.fp3 MSPCA NAMEA SeriExpl.fp3 RPTHA SeriExpl.fp3 SeriExpl.fp3 FMP3FMP3 Troi-Serial-Plug-in1.0b1 \KES:Projecten:Troi Plug-In 981215:Troi Plug-ins:SERIAL:Troi-Serial-Plug-in1.0b1:SeriExpl.fp3 McGee peter